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First Methods 


Recall that we have already seen the use of a few meth- 
ods: 


e System.out.println() ; will print a blank line; more 
generally it will print out whatever is inside the paren- 
thesis — whether String or variable value. We also 
had System.out.print(...); which printed out 
whatever was in the parenthesis without printing a 
newline after it. 


e Keyboard.readInt(); will read in an integer from 
the keyboard as input; more generally we also had 
methods to read in a char, a double, or a String. 
Once it read in that value, it sent it back to main() 
to be stored in a variable. 


Writing our own methods 


One of the strongest program organization tools we 
have is the idea of methods. Just as the statement 
System.out.printin(...); (with something real in 
the parenthesis) was a stand-in for some collection of in- 
structions supplied by the system, likewise we can write 
our own collection of code statements and use a method 
name to stand in for our collection of statements. 

This leads to a more organized form of program de- 
sign that serves us better as our programs become larger. 
Rather than write a complete program in main(), in- 
stead we break our task up into logical units, and we 
code a method for each unit. main() then becomes a 
“summary of our program, invoking the various meth- 
ods one by one until the task is completed. So, reading 
over main() will still give us a general idea of what is 
going on in the program, but the details are left to the 
actual methods that are called from main(). This form 
of programming is known as structured programming, 
because you are taking the large collection of statements 
in main(), and providing structure to that collection by 
breaking its elements into logical subcollections. 

By doing things this way, we can “reuse” those details. 
Instead of writing code to perform a task many times, we 
simply write it once, in a method, and then make use of 


that method whenever we need that code. In addition, if 
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we need to make changes to the code in question, we only 
need to change it once, in the method, and not in many 
places all over the program. ‘This organization also makes 
a program easier to read, especially if you are new to the 
program and are seeing the code for the first time, because 
you can read the “overview” of the code and get a basic 
idea of how the program runs, without having to inspect 
every detail of every method. As long as the method 
names are descriptive and the code is well-commented, 
there should be little to no reason to have to inspect the 
details of every method simply to understand how the 
code works. 


Declaring methods 


We will first go through a simple example, where we 
write a method to add three integers. Now, of course we 
can add three integers just fine without a method, but 
the point here is to illustrate how methods work, so we'll 
start with something easy. 

Let’s call our method Add3. Now, methods need more 
than just a name. They also need: 


l. a return type — the type of value being returned. For 
example, Keyboard.readInt () sends back an int to 
whoever called the method. System. out . println() 
sends back nothing. When writing a method, you need 
to indicate the type of the value that is returned by 
the method (you can return only one value). If you 
don’t return any value, then you indicate this via the 
“placeholder” type void. 


2. zero or more parameters — a kind of variable specific 
to methods. ‘These variables require that you pass 
values to the method to be stored in these variables, 
or else you can’t use the method. Sending values to a 
method will result in them being automatically stored 
in the method’s parameters — and you can then use the 
parameters as variables in the code for the method. 


Parameters 


Listing a single parameter is very similar to declaring 
a variable, in that you need both a type and a name. 
We need the name so that we can refer to this parameter 
inside the method code in the same way we would refer 
to any other variable. And, of course, all variables need 
a type, so that is why the parameter needs a type. 


So, the form for listing a single parameter is: 
paramType paramName 


and the form for a list of parameters is to list single pa- 
rameters, separated by commas. For example, if you had 
three parameters, those three parameters would be listed 
as follows: 


typel nameil, type2 name2, type3 name3 


For example, if we wanted a boolean, a char, and an int 
as parameters, we would pick names for these parameters 
and list them as follows: 


boolean done, char oneChar, int value 


Completing the method signature 


The form for the first line of a method definition is: 


return-type method-name(ti pi,...,tn pn) 


where 


(ti pi,...,tn pn) 
is 
(type1 parami,...,typeN paramN) 


We want our “Add3” method to accept three integers and 
return their sum. The sum of three integers will certainly 
be an integer as well. So, the first line of our Add3 method 
should be as follows: 


int Add3(int x, int y, int z) 


In this method, the return type is int, and the names 
of our three parameters of type int are x, y, and z. We 
will return to this method in just a bit to finish writing 
its code. 


Using methods 


We have focused on the first line of the method — called 
the method signature — up until now because that is all 
that is needed to know how to use the method. We can’t 
call it unless we know its name; knowing the return type 
lets us know how to make use of whatever value might 
be sent back by the method, and knowing the parameters 
allows us to pass the appropriate values into the method. 

The details of how the method does its job are unimpor- 
tant, from the standpoint of calling the method. That is 
why we don’t need to know how Keyboard. readInt () 
or System.out.println() work in order to use them. 
We simply need to know what the method is supposed to 
do, what parameters it needs to do this task, and what 
the type is of the value that gets returned, if there is 
indeed any value returned. 


The general form for calling a method — as you have 
already seen with the methods you have used — is to write 
the method name, and then in parenthesis list any values 
being sent to the method. 


method-name(argumenti,...,argument n); 


The values you send in are called arguments. Using 
the method is known as calling the method or invoking 
the method. 

So, if we want to invoke our Add3 method, we need to 
pass in three arguments of type int, because Add3 has 
three parameters of type int that need values. ‘There are 
many ways we might do this; below is one way, where we 
send in actual integer literals: 


Add3(2, 1, 5); 
We might also have int variables a, b, and c that we use 
as arguments: 

Add3(a, b, c); 
or any combination of int variables and integer literals, 
such as: 

Add3(a, b, 2); 


Add3(5, c, b); 
Add3(2, a, 6); 


We also need to make use of the value returned by this 
method, so we would call Add3 the same way we called 
Keyboard.readInt(), namely, as part of an assignment 
statement. 


public class Program 


{ 


public static void main(String[] args) 


{ 


int a, b, c, d; 


a= 2; 
b = 1; 
C= 53 
d = Add3(a, b, c); 


Completing the method definition 
We have the first line of our method definition: 
int Add3(int x, int y, int z) 
and now need to finish the definition. First, we need open- 
and close- braces. Just as we turned a collection of state- 
ments into a single compound statement in conditionals 
and loops by enclosing them in braces, we do the same 
thing with methods. The difference here is that you have 
to have the braces; even if a method has only one line of 
code, it needs to be enclosed in a pair of braces. 


int Add3(int x, int y, int z) 
{ 





// code goes here 


. 


As far as what code is needed, well, we are trying to add 
three numbers, and we are pretending that you cannot 
chain additions together on one line, even though you 
can, so let’s declare a variable to hold the sum, and then 
progressively add to it. 


int Add3(int x, int y, int z) 
{ 








int sum; 
sum = x + y; 
sum = sum + Z; 


Completing the method definition — return statements 


We have calculated the sum, but the last thing we need 
in our Add3 method is a way of sending the sum back as 
the return value of the method. This is done via a return 
statement. The syntax of a return statement is: 


return expr; 


where expr is some expression (perhaps a non-existent 
one; more on that later). As we have already seen, an 
expression can be very complex, or it can be as simple as 
a single literal or variable. In this case, it will only be a 
single variable, namely, sum. 


// Final version of this method 
int Add3(int x, int y, int z) 


{ 
int sum; 
sum = x + y; 
Sum = sum + Z; 
return sum; 

+ 


The statement return sum; sends back the value of sum 
as the return value of this method. Since the method is 
supposed to return a value of type int, and since sum is 
indeed a variable of type int and thus holds a value of 
type int, everything matches up perfectly. 
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Overall code (info on next slide) 


public class Program 


af 


public static void main(String[] args) 


if 


; 


int a, b, c, d; 


a= 2; 
b = 1; 
C=2.53 
d = Add3(a, b, c); 


System.out.println("Total is " + d); 


public static int Add3(int x, int y, int z) 


{ 


int sum; 

sum = x + y; 
sum = sum + Z; 
return sum; 


Note that “public static” appears in front of our 
new method just like it appears in front of main(). 
In a programming language, the name, parameters, 
and return type are the important parts of a method. 
Those are the things you need in order to make meth- 
ods work in general. The public and static key- 
words in front of our method definitions are things 
that are specific to object-oriented programming. We 
will learn what they mean, but not right now, so for 
now just that assume all methods you write should 
have public static in front of them, and later on 
we will learn what it means to leave them out or to 
use different words instead. 


The parameters of Add3 can be thought of as a special 
kind of local variable. The local variable sum must be 
declared and assigned inside the braces, but the pa- 
rameters x, y, and z are “declared” before the open 
brace is reached, and are also assigned values before 
the open brace is reached (the values they are assigned, 
of course, being the values of the arguments sent in to 
Add3). Other than that, they function exactly the 
same way as any local variable such as sum that you 
declare and assign within the braces themselves, and 
thus you can use those parameters in your code the 
same way you'd use any other variable that you de- 
clared and assigned yourself. 
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Scope in methods 


When we went over loops we talked a little about the 
scope of variables. Specifically, we said that a variable 
declared within the braces ({}) of a compound statement 
will vanish from existence and no longer be accessible 
once you have reached the closing brace of that compound 
statement block. 

Methods work in a very similar manner. 


e Variables declared within a method have as their scope 
the life of the method; they vanish when the method 
ends. 


e Other variables in other methods are not accessible 
from that method. So, if from main you invoke Add3, 
you cannot access main’s local variables from Add3. 


Thus, the method scope rule is: 


e Variables declared in a method are only accessible in 
that method, and in no other methods anywhere else 
in the program. A method’s parameters work the 
same way as any other local variables of a method 
and thus go out of scope at the end of the method. 


Visual example of method calling 


As far as having a visual example of method calling, an 
analogy to notecards works nicely. ‘This is because, as we 
have now discussed, the scope for a local variable is that 
method only — it is not available to any other method. So, 
we can think of each method call as being on a separate 
notecard, and the variables declared in that method are 
unique to that method call — just as if we write some 
numbers on a notecard, they are unique to that notecard 
and don’t magically appear on other notecards as well. 

So, we start off with main (we’re running the code from 
a few slides back): 





Above we see the main method after the declarations 
have been made. We have made no assignments, so we 
consider the values in the variables unknown. 





Next, we will run the three lines of code that assign 
values to three of the variables. 


And now we reach the method invocation line. As al- 
ways, the expression on the right-hand-side of an assign- 
ment statement is evaluated to obtain its value before the 
actual assignment of that value to the variable is done. 
Here, that means we complete the Add3 method call be- 
fore writing the result to d. This just makes sense. 

So, let’s set up a new notecard for Add3. Since we are 
leaving main and thus don’t have access to its variables 
until we return to it, we will place this new notecard on 
top of the one for main. In this manner we make it 
clear that Add3 (the method on the top notecard) is the 
currently-active method, and that the methods on note- 
cards below it (in this case, only main) are methods we 
will eventually return to later on as we complete method 
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calls we have begun. 


|__| Add3 3 y: Zs 


When we first call the method, we have three parame- 
ters that need to be assigned values. ‘These parameters 
are automatically assigned the corresponding values from 
the method call code line itself. ‘That is, the first argu- 
ment’s value is written into the first method, the second 
argument’s value is written into the second method, and 
so on. 

So, above, the value inside a is copied into x, the value 
inside b is copied into y, and the value inside c is copied 
into Z. 





|__| Add3 x 2 y: 1 Zeu5 


Now, we start the actual code of the Add3 method. 
First we declare the local variable sum (picture squished 
to fit it on this slide): 


Next, we run sum = x + y5... 


| 
|__| Add3 50, a2 aome ZaN5 | 
| 
| 


Finally, we come to the statement return sum;, which 
signifies the end of the method. What happens here is 
that the machine stores the value of sum in a “return 
value” location, and then the method is concluded, mean- 


ing that the parameters and local variables go out of scope 
20 


and thus vanish”. In pictoral terms, this is equivalent to 
lifing up the notecard and throwing it away. 


return 
value: 8 


| 
| 
| 
| oI\ v6 \ 7 -% j \ / 
|__| \dd/ K2\2 7 yo’ f Ze by. 7 
| \/ \/ \/ \/ 
| / \sum: 8 / \ / \ i 
Wes Noe | ES CTE, ED, SRR | a ae | 


And finally, the return value gets used in the assignment 
statement... 


| 

| return 
| value: 8 
| 

| 


...after which the return value itself vanishes (it only gets 
stored temorarily, until the assignment statement was 
over). 


And now, we are back in main, with a value stored inside 
d. However, it is a value we generated using a method 
call, instead of a value we generated directly in main using 
only the values of local variables and language operators 
(in this case, addition). 








In general, the code inside a method can be as simple or 
as complex as you want. The code will probably tend to 
be pretty simple in this class to start with, since we want 
you to focus on learning method syntax. But usually, 
very simple code is better left in main, and a method 
should be written for a task that takes more than just 
one or two lines of code. As with so much else, knowing 
when to write a method and when not to is a matter of 
experience and programming style. 





The notecard analogy works especially nicely for meth- 
ods because methods don’t have the ability to communi- 
cate with each other freely due to the scoping rules for 
local variables of methods. ‘Two different method calls re- 
ally are two separate, distinct processing segments. The 
only ways that they can communicate are: 


1. the calling method can send data to the invoked method 
by passing arguments obtained in the calling method 
to the invoked methods parameters, and 


2. the invoked method can send data back to the calling 
method by returning a value (which is why we have a 
return type). 


One last remark — compilation checks 


The compiler does a lot of consistency checking when 


compiling code that uses methods. For each method call, 
the following things are checked: 


ib 


The name of the method on the calling line must 
match the name of some actual method that has been 
written. 


. The number of arguments being sent to this method 


must match the number of parameters the method 
has, and their types must match in order — i.e. type 
of first argument must equal type of first parameter, 
type of second argument must match type of second 
parameter, and so on. 


._ If there is a return type other than void, then there 


must be a return statement in the method. 


. If there is a return type other than void — and thus, 


by definition, a return statement in the method — then 
the value of the expression in the return statement — 
which is the value being returned — must have a type 
equal to the stated return type. You can’t return a 
boolean value from a method with an int return 
type, for example. 


. The method call statement must be used in a way con- 


sistent with its return type. For example, you cannot 
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have a method call to a method that returns void as 
the right-hand-side of an assignment statement. You 
cannot have a method call to a method that returns 
a value of type boolean as the right-hand-side of an 
assignment statement that assigns to a int variable. 
You cannot have as an argument to the logical oper- 
ator NOT (!) a method call that returns int (NOT 
needs a boolean value for an argument). And so on. 


This makes life very nice for you, because you can focus 
on simply using methods correctly from a logic and design 
standpoint, and you can let the compiler catch any syntax 
or calling/returning consistency mistakes you might have 
made. 


